home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 751-760 / 759 / abackup / abackupenglish.doc < prev    next >
Text File  |  1995-03-18  |  34KB  |  686 lines

  1.  
  2.                 ABackup - User's Manual
  3.  
  4.  
  5.  
  6.  
  7.  
  8.   1. Foreword
  9.  
  10.       This manual describes release 1.60  of  the  utility    ABackup.  This
  11.   program is (c)1992 by  Denis  GOUNELLE,  any  commercial  usage  or  selling
  12.   without author's written authorization is strictly forbidden. You  can  copy
  13.   and spread this program at the following conditions:
  14.  
  15.     - all the files must be provided
  16.     - none of the file must have been modified
  17.     - you don't charge more than $6 for copy fee
  18.  
  19.       In spite of several tests, no warranty is made that there's no error
  20.   in ABackup. YOU USE THIS PROGRAM AT YOUR OWN RISKS. In no event  will  I  be
  21.   liable for any damage, direct or indirect, resulting of the use of  ABackup.
  22.  
  23.   2. Introduction
  24.  
  25.       ABackup is a backup program written for the Amiga. It works the same
  26.   under 2.04 and 1.3 system releases, can be used both to  make  a  backup  of
  27.   your hard disk or to archive files, and  has    a  full  Intuition  interface.
  28.   Under 2.04 system release, ABackup is able to recognize links and to    manage
  29.   high density disks.
  30.  
  31.       This program is SHAREWARE. If you find it useful, I  invite  you  to
  32.   send me $10 at the address listed below in  order  to  become  a  registered
  33.   user. Please use only :
  34.  
  35.       - checks from a French bank
  36.       - cash (French Francs prefered, otherwise any currency of the E.E.C.  is
  37.     accepted, as well as US dollars and Swiss  Francs  ;  in  either  case
  38.     please add a little more for change fee)
  39.       - checks from an European bank
  40.  
  41.   If you send me a check, it must be in French Francs and the beneficiary must
  42.   be "M. GOUNELLE Denis". In either case,  as  a  registered  user,  you  will
  43.   receive the next version of ABackup as soon as it  will  be  available.  You
  44.   should be aware that this contribution fee only gives right to  one  update.
  45.   If you want to receive the next updates regularly,  a  $20  contribution  is
  46.   required.
  47.  
  48.       Suggestions and/or criticisms will be always welcome. Don't hesitate
  49.   to write me at the following address :
  50.  
  51.                    M. GOUNELLE Denis
  52.                     Boite 71
  53.                   6, rue des cailloux
  54.                  92110 CLICHY - FRANCE
  55.  
  56.       Thanks to Michel SCHINZ (without him, this program  would  be  still
  57.   only at the planning stage)  and  Jean-Yves  PROUX  for  their  suggestions.
  58.   Special thanks to  Jean-Philippe  RAPP  for  his  numerous  suggestions  and
  59.   constant supporting.
  60.  
  61.   3. Getting started
  62.  
  63.       ABackup can be run as well from CLI as from Workbench. From the CLI,
  64.   you can invoke ABackup by a syntax as follows :
  65.  
  66.       ABackup [FROM directory] [BUFSIZE size] [NOCOMP ext,ext,...]
  67.  
  68.       The BUFSIZE option allows to change the size of the read buffer (for
  69.   example "BUFSIZE 64" asks for a 64 Kb buffer). By default, the  buffer  size
  70.   is 4 Kb large. You can specify a directory name for backup (with the  "FROM"
  71.   option); by default, this one will be  the  current  directory.  The    NOCOMP
  72.   option allows to specify extensions of file names to don't compress. You can
  73.   specify  up  to  10  extensions,  separated  by  a  comma   (e.g.:   "NOCOMP
  74.   .info,.run").
  75.  
  76.       From the Workbench, you can change the size of the  read  buffer  by
  77.   adding a line of the form "BUFSIZE=<size in Kb>" in the "TOOL  TYPES"  field
  78.   of ABackup icon. You can also specify extensions  of    file  names  to  don't
  79.   compress by adding a line of the form "NOCOMP=ext,ext,...".
  80.  
  81.       When the program starts, a screen is displayed with several  gadgets
  82.   in it : "Backup an AmigaDOS partition", "Restore", "Rebuild catalogue",  and
  83.   "Quit". Click on the gadget that matches the wanted action.
  84.  
  85.   4. Requesters
  86.  
  87.       When using ABackup, often you'll see requesters with one message and
  88.   one or two gadgets ("Ok", "Continue/Abort", "Yes/No").
  89.  
  90.       In any case, you can reply to a request by clicking on one of  these
  91.   gadgets, or by pressing the key corresponding to the first letter of a reply
  92.   (for example, the "c" or  "C"  key  for  "Continue").  You  can  also  press
  93.   <RETURN> for a positive reply ("Ok",  "Continue",  "Yes")  or  <ESC>  for  a
  94.   negative reply ("Abort", "No").
  95.  
  96.       Finally, when a requester message asks for inserting a disk  in  one
  97.   drive, inserting a disk in this drive will be  detected  and    this  will  be
  98.   equivalent to clicking on the "Continue" gadget.
  99.  
  100.   5. Backup an AmigaDOS partition
  101.  
  102.       A requester is displayed that allows    to  choose  the  directory  to
  103.   backup. By clicking on the "Cancel" gadget, ABackup will return to the  main
  104.   screen. By clicking on the "OK" gadget,  ABackup  will  load  the  directory
  105.   contents. For breaking this loading, click on the "Abort"  gadget  or  press
  106.   one of the following keys : "a", "A", <ESC>.
  107.  
  108.       As directory contents is loaded, the selection screen is  displayed.
  109.   This screen consists of a gadgets set and a bottom area where are  displayed
  110.   files and subdirectories of the current directory. At the start, no file and
  111.   no directory are selected. Files are displayed in black on grey  background,
  112.   and directories in white on grey. Directories with at least  one  descendant
  113.   selected are displayed on a  black  background.  You    can  scroll  the  list
  114.   display by means of the vertical scroll bar on the right. The  name  of  the
  115.   current directory is displayed in the area named "Directory". The number and
  116.   size of the selected files are displayed in the area named "Selection".
  117.  
  118.       For selecting a file in a list, click on the name of this file :  it
  119.   is displayed in black on a blue  background  and  the  "Selection"  area  is
  120.   updated. If you click on a selected file, this one will be  unselected.  For
  121.   selecting or unselecting a set of files, click on the first  file  and  keep
  122.   down the left button while moving your mouse. Last, to  view    a  file,  just
  123.   double-click on its name (see below for details).
  124.       When you click on a directory name, two actions can happen. If  this
  125.   directory is empty, it will be selected or unselected as a file.  Otherwise,
  126.   the list display will be modified in order to make visible the  contents  of
  127.   this directory. The "Directory" area will be updated.  To  go  back  to  the
  128.   previous directory, you can either click on the "Parent" gadget (at the  top
  129.   of the scroll bar), either click on  the  hidden  gadget  between  the  left
  130.   border of the screen and the left border of the display area.  If  you  went
  131.   very down in the tree structure, you can go back  straight  at  the  initial
  132.   directory by clicking on the "Root" gadget (at the top of the scroll bar).
  133.  
  134.       At the top of the screen, there are two rows of  identical  gadgets.
  135.   These ones allow to select (first row) or to  unselect  (second  row)  files
  136.   and/or subdirectories in a global way according to various criterions :
  137.  
  138.   All
  139.       Selects or unselects all files and subdirectories from  the  current
  140.       directory.
  141.  
  142.   By name
  143.       Selects or unselects files and subdirectories according to a name or
  144.       a pattern. A pattern is a name with  one    of  the  special  AmigaDOS
  145.       characters: '#' or '?' under 1.3 system release, '#', '?', '|', '~',
  146.       '%', parenthesis, or brackets under 2.04 system  release.  For  more
  147.       informations, refer to your AmigaDOS User's manual.
  148.       A window is displayed with a string gadget. Type in it a name  or  a
  149.       pattern and validate your choice by pressing  <RETURN>.  Now,  click
  150.       either on the "==" gadget, if you want files or subdirectories whose
  151.       name matches the name or the pattern you typed, either on  the  "!="
  152.       gadget, if you want files or subdirectories whose name doesn't match
  153.       the name or pattern you typed. You  can  cancel  this  operation    by
  154.       clicking on the window close gadget.
  155.  
  156.   By date
  157.       Selects or unselects files and subdirectories according to the  date
  158.       of the last change. A window is brought up  with    a  string  gadget.
  159.       Type in a  date  and/or  time  respecting  the  following  syntax  :
  160.       DD-MM-YY or DD-MMM-YY for  the  date  (for  example,  "01-03-92"  or
  161.       "01-Mar-92"),  and  HH:MM:SS  for  time.  Validate  your  choice  by
  162.       pressing the <RETURN> key, then click over the "<="  gadget  or  the
  163.       ">=" gagdet,  according  as  you  want  to  get  earlier  files  and
  164.       subdirectories or later ones in relation to the typed date.
  165.       If you typed only time, the date will be the day date. If you  typed
  166.       only a date, time will be "23:59:59", when you click over  "<=",  or
  167.       "00:00:00", when you click over ">=". You can cancel this  operation
  168.       by clicking on the window close gadget.
  169.  
  170.   By bits
  171.       Selects or unselects files and  subdirectories  according  to  their
  172.       protection bit. A window is brought up with  a  string  gadget.  For
  173.       testing one or several bits (see the  AmigaDOS  command  "Protect"),
  174.       type them in this gadget and validate your choice  by  pressing  the
  175.       <RETURN> key. Click now over the "= 1" or "= 0" gadget according  as
  176.       you want files and subdirectories with their bits set or unset.  You
  177.       can cancel this operation by clicking on the window close gadget.
  178.  
  179.       The "Reverse" gadget allows to invert a  selection  :  all  selected
  180.   files become unselected  and    all  unselected  files    become    selected.  The
  181.   "Recursive" gadget controls the action of the "Reverse" gadget, just  as  it
  182.   controls the "All", "By name", "By date" and "By bits" gadgets : it shows if
  183.   selecting or unselecting will or will not concern  files  that  are  in  the
  184.   subdirectories of the current directory.
  185.       Last, the "OPTIONS" and "START"  gadgets  allows  to  modify  backup
  186.   options and to start backup (see just below).
  187.  
  188.       The selection screen has three menus too. The "Size" menu allows  to
  189.   change unit ABackup is using to display the size of selected files. You  can
  190.   choose beetween Bytes (the default unit), Kilobytes and  Megabytes.  If  you
  191.   select the "Automatic" item, ABackup  will  automatically  change  of  unit,
  192.   depending  of  the  size  of    selected  files.  Later,  we'll  describe  the
  193.   "Selection" menu. The "Backup" menu has the following options :
  194.  
  195.   Start
  196.       Allows to start backup. If you selected no file and no subdirectory,
  197.       an error message will be displayed. The backup progression  will    be
  198.       explained below.
  199.  
  200.   Options
  201.       Allows to change the backup options. These options are as follows  :
  202.  
  203.       Compress
  204.       Files are compressed in order to bring down the backup size (you
  205.       can hope for a space-saving from 30% to 50%). Note  that  backup
  206.       is seriously slowed down with a "normal" 68000 based Amiga. Note
  207.       also that ABackup will not try to compress files with a  ".lha",
  208.       ".lzh", ".zoo", ".arc", ".pp" or ".z" file  name  extension,  as
  209.       well as any file less than 512 bytes long. You can specify other
  210.       extensions to don't compress,  with  the  NOCOMP  argument  (see
  211.       section 2).
  212.  
  213.       Verify
  214.       Reread and compares every track  after  writing  it.    Meaningful
  215.       only for backup to disks.
  216.  
  217.       Backup links
  218.       Backup  selected  links.  Meaningful    only  under  2.04   system
  219.       release. An archive  which  contains    links  can  of    course    be
  220.       restored even under 1.3 system release (links will simply be not
  221.       restored).
  222.  
  223.       Set archive bit
  224.       Once backup is over, sets the  archive  bit  (see  the  AmigaDOS
  225.       command "Protect") of all files and subdirectories  successfully
  226.       backed up.
  227.  
  228.       Backup report
  229.       Indicates if ABackup has to create a backup report. This one can
  230.       be printed or written to a file.
  231.  
  232.       Backup to
  233.       Selects an archive. If a given name is of the form "df?:"  (e.g.
  234.       df0:, df1:, etc....), ABackup will use the specified    disk  unit
  235.       by writing on disks in a special format. In this case, you  need
  236.       not to format your backup disks. Otherwise, ABackup will  create
  237.       an archive file with the name you specified.    Note  ABackup  has
  238.       the capability of creating this file on any device that  accepts
  239.       the AmigaDOS "Seek" function.
  240.       You can use several disk drives for backup : specify    the  names
  241.       of the drives separated by a coma. For exemple, if  you  specify
  242.       "df0:,df1:" ABackup will start with disk in df0:, then  continue
  243.       with the disk in df1:, go back to df0:, etc... The program  will
  244.       automatically (without requester) toggle from one drive  to  the
  245.       next, if the disk in the new drive has been changed.
  246.  
  247.       At the bottom  of  the  window,  three  gadgets  allow  to  validate
  248.       changes, to validate and save your new options or to clear  changes.
  249.       Options are saved in the "S:ABackup.config" file, that is loaded  at
  250.       every program starting.
  251.  
  252.   Estimations
  253.       Gives an estimation of backup  time  and    of  the  number  of  disks
  254.       needed. The result depends of the size of  the  selected    files,    of
  255.       backup options, and of the processor inside your Amiga. It  may  not
  256.       be accurate if other tasks are running during  the  backup.  ABackup
  257.       always suppose that you backup a hard disk to floppies.
  258.  
  259.   About...
  260.       Displays some informations  on  this  program.  To  continue,  click
  261.       within the window, over the window close gadget or press any key.
  262.  
  263.   Abort
  264.       Allows to abort whole operation. After it asked to confirm,  ABackup
  265.       returns to the main screen.
  266.  
  267.       For starting a backup, you have to select the  "Start"  item  in
  268.   "Backup" menu or the "START" gadget. If you asked for backup  report  to
  269.   be written to a file, a requester will be brought up    so  that  you  can
  270.   specify a name for this file. If you click over the  "Abort"  button  in
  271.   this requester, no report will be generated.
  272.       At this time, a new screen is brought up with different infos on
  273.   the backup progression. In the bottom area,  the  file  names  pass  by,
  274.   followed by an info on  the  current    operation  (compression,  writing,
  275.   etc....). If an error occurs (and if this  is  possible),  ABackup  will
  276.   display a message to ask if you want    to  continue  in  spite  of  that.
  277.   Obviously, ABackup will not make  a  backup  for  the  file  that  maked
  278.   problem. If you asked for a disk backup, you can remove  the    last  disk
  279.   from your drive  as  soon  as  the  "Archive  closed"  message  will  be
  280.   displayed.
  281.       At the top and on  the  right  of  this  screen  there  are  two
  282.   gadgets. The "* ABORT *" gadget allows to abort a backup. After it asked
  283.   to confirm, ABackup returns to the  selection  screen.  The  "* PAUSE *"
  284.   gadget allows to pause a backup for a while. Note that  it  can  happens
  285.   ABackup doesn't react immediatly  when  you  click  over  one  of  these
  286.   gadgets but, in all cases, your request will be  registered  before  the
  287.   next write operation in the archive.
  288.       Once a backup ended (a message will inform you of that), ABackup
  289.   returns to its main screen.
  290.  
  291.   6. Viewing
  292.  
  293.       From the selection  screen,  you  can  view  any  file  just    by
  294.   double-clicking on its name. A window appears, with several gadgets.
  295.       The three upper gadgets show the name of  the  viewer  for  each
  296.   file type: ASCII file, IFF picture, or other file. You can modify  these
  297.   default names. If you change the name of the viewer corresponding to the
  298.   currently selected file, this new value will be copied in the  "Execute"
  299.   gadget.
  300.       The "Execute" shows the name  of  the  viewer  to  use  for  the
  301.   selected file. The file type is displayed above (in white). You can,  of
  302.   course, modify the name of the program to use.
  303.       The three  lower  gadgets  allow  you  to  start  viewing  ("OK"
  304.   gadget), to save default names and start viewing ("SAVE" gadget), or  to
  305.   abort operation ("CANCEL" gadget).
  306.       If you try to view a link, ABackup will just display the name of
  307.   the file or directory the link points to.
  308.  
  309.   7. Restore
  310.  
  311.       A menu is brought up allowing to specify the archive    that  must
  312.   be used. If you click on the "Abort" gadget, ABackup will return to  the
  313.   main screen. The gadgets corresponding to your drives are  automatically
  314.   enabled or disabled according to your  hardware  configuration.  If  you
  315.   click on one of these enabled gadgets, ABackup will ask  you    to  insert
  316.   the last disk in the backup set, for loading the catalogue. If you click
  317.   on the "File" gadget, a requester will be brought up so that you specify
  318.   your archive file. If you click on  the  "Abort"  gadget,  ABackup  will
  319.   return to the main screen.
  320.  
  321.       Once you  have  selected  an    archive,  ABackup  will  load  the
  322.   catalogue of files backed up    in  this  archive  and    will  display  the
  323.   selection screen. This screen is exactly identical as that one used  for
  324.   backup. Only the "Options" window is different. Options are as follows :
  325.  
  326.   Restore dir. tree
  327.       Indicates if selected files will be all  restored  in  the  same
  328.       directory (NO) or if the tree structure  will  be  restored  too
  329.       (YES).
  330.  
  331.   Restore date
  332.       Indicates if ABackup will set the date of restored file  to  the
  333.       date they had at backup time.
  334.  
  335.   Restore links
  336.       Restore  selected  links.  Meaningful  only  under  2.04    system
  337.       release.
  338.  
  339.   Restoration report
  340.       Indicates if ABackup has to generate a restoration report.  This
  341.       one can be printed or written to a file.
  342.  
  343.   Restore empty dirs
  344.       Indicates if ABackup has to create empty backed up  directories.
  345.  
  346.   Replace files
  347.       Indicates what ABackup has to do if a file  it  has  to  restore
  348.       already exists. Choices are : "No" (file is not replaced), "Yes"
  349.       (file is replaced), "Ask for" (ABackup will ask to  confirm  for
  350.       every existing file), "Older" (ABackup replaces this  file  only
  351.       if this one is older than the backed up file).
  352.  
  353.   Restore to
  354.       Usually, files are restored in the directory where they were  at
  355.       the time of the backup, but you can specify another directory by
  356.       this gadget.
  357.  
  358.       For starting a restoration, you have to select the "Start"  item
  359.   in "Restore" menu or the "START" gadget. If you  asked  for  restoration
  360.   report to be written to a file, a requester will be brought up  so  that
  361.   you can specify a name for this file. If  you  click    over  the  "Abort"
  362.   button in this requester, no report will be generated.
  363.       At this time, a new screen is brought up with different infos on
  364.   the restore progression. In the bottom area, the names of restored files
  365.   pass by,  followed  by  an  info  on    the  current  opération  (reading,
  366.   etc....). If an error occurs (and if this  is  possible),  ABackup  will
  367.   display a message to ask if you want    to  continue  in  spite  of  that.
  368.   Obviously, ABackup will not restore the file that maked problem. If some
  369.   links are to be restored, ABackup will  restore  them  after    all  other
  370.   files and directories are restored.
  371.       At the top and on  the  right  of  this  screen  there  are  two
  372.   gadgets. The "* ABORT *" gadget allows to abort a restoration. After  it
  373.   asked  to  confirm,  ABackup    returns  to  the  selection  screen.   The
  374.   "* PAUSE *" gadget allows to pause restoration for a while. Note that it
  375.   can happens ABackup doesn't react immediatly when you click over one  of
  376.   these gadgets but, in all cases, your request will be registered  before
  377.   the next read operation in the archive.
  378.       Once a restoration ended (a message will inform  you  of  that),
  379.   ABackup returns to its main screen.
  380.  
  381.   8. Rebuild catalogue
  382.  
  383.       This function is not very useful unless an archive file has been
  384.   damaged, or you have loose the last  disk  of  a  backup  set.  It  will
  385.   rebuild the archive catalogue, which is required to restore. You  should
  386.   be aware that this function can't handle all  errors,  and  may  not  be
  387.   usuable by unexperienced users.
  388.  
  389.       If the archive is a file, you should make a copy of it in  order
  390.   to avoid to destroy it if operation fails. You will also have  to  check
  391.   that the first header is at a sector boundary, that is,  at  an  address
  392.   multiple of 512 (you can use the "TYPE archive HEX" command,  the  first
  393.   and the third long word of a header are always set to the "ABCK" value).
  394.   If the archive is on disks, you must give the disks in  the  same  order
  395.   they were written to. This function works even if disks are missing.
  396.  
  397.       The archive selection screen    appears  (see  previous  chapter).
  398.   When you have selected the archive,  ABackup    loads  its  content,  file
  399.   after file : a new screen  appears  with  some  informations    about  the
  400.   processing. Once the content    is  loaded,  the  new  catalogue  will    be
  401.   created. If the archive is on disks, ABackup will ask you for a new disk
  402.   to write the catalogue. Use this disk a the last disk of the backup set,
  403.   when restoring.
  404.  
  405.   9. The "Selection" menu
  406.  
  407.       ABackup has the capability of recording a file selection so that
  408.   you can recall it later : this can be useful if you use  frequently  the
  409.   same selections. These ones are kept as text files containing a  set    of
  410.   commands : these files are in the "ABCK:" directory.
  411.       In order to record a selection, choose the "Record" item in  the
  412.   "Selection" menu; then, do your selection as you do usually. Note  that,
  413.   during this recording, the "Backup" menu disappear (for the time being).
  414.   Once you have ended, select the item "Save" in the "Selection"  menu  to
  415.   save your selection. If you want to abort a recording, choose  the  item
  416.   "Abort" in the "Selection" menu.
  417.       To recall a selection, choose the "Load" item in the "Selection"
  418.   menu. A file requester will be displayed allowing  you  to  specify  the
  419.   selection file you want use. If you click on the  "OK"  gadget  in  this
  420.   file requester, that file will be loaded and selection it contains  will
  421.   be executed.
  422.  
  423.       This is description of the selection language used  by  ABackup.
  424.   This allows to create or modify a selection file as you like,  by  means
  425.   of your usual text editor.
  426.  
  427.       CD :                  go back to root directory
  428.       CD /                  go back to parent directory
  429.       CD "dir"                        go down in given directory
  430.       INVERT                  reverse selection
  431.       RECURS {YES|NO}              set recursivity flag
  432.       INCLUDE ALL              include all files
  433.       INCLUDE "name"                  include given file
  434.       INCLUDE NAME "name" {==|!=}     select by name
  435.       INCLUDE DATE "date" {<=|>=}     select by date
  436.       INCLUDE BITS "bits" {=0|=1}     select by protection bits
  437.       EXCLUDE ALL              exclude all files
  438.       EXCLUDE "name"                  exclude given file
  439.       EXCLUDE NAME "name" {==|!=}     exclude by name
  440.       EXCLUDE DATE "date" {<=|>=}     exclude by date
  441.       EXCLUDE BITS "bits" {=0|=1}     exclude by protection bits
  442.  
  443.   Here is an exemple of selection file:
  444.  
  445.       RECURS YES
  446.       ; go back to root
  447.       CD :
  448.       ; clear any selection
  449.       EXCLUDE ALL
  450.       ; include all files with archive bit cleared
  451.       INCLUDE BITS "a" =0
  452.       ; exclude all ".o" files
  453.       EXCLUDE NAME "#?.o" ==
  454.  
  455.       Note that empty lines and lines starting by a ";" character  are
  456.   ignored. Also note that ABackup  stores  automatically  the  recursivity
  457.   indicator state at the beginning of your selection record : if you  take
  458.   a look at the created files you'll see they all  beging  by  a  "RECURS"
  459.   command. If you want to be sure to  clear  a    previous  selection,  it's
  460.   recommended to start all your  selections  by  clicking  on  the  "ROOT"
  461.   gadget and then on "EXCLUDE ALL".
  462.  
  463.   10. Usage without interface
  464.  
  465.       ABackup can be used from CLI, without  it's  graphic  interface.
  466.   This may be useful for doing    automatical  backup,  with  programs  like
  467.   "cron". Four operations are allowed from this  level:  backup,  restore,
  468.   rebuild catalogue, archive listing.
  469.  
  470.       Backup is started with a command like:
  471.  
  472.       ABackup BACKUP FROM dir TO arc  SELECT  {ALL|ARC|file}  [OPTIONS
  473.       {C|V|A|L}] [NOCOMP ext,ext,...] [VERBOSE] [REPORT file] [BUFSIZE
  474.       size]
  475.  
  476.   where "dir" is the directory to backup and "arc" the name of the archive
  477.   to create. The "SELECT" argument allows to select files  to  backup:  it
  478.   must be followed by the name of a selection file (see previous  section,
  479.   for exemple "ABCK:FullBackup"), by the  keyword  "ALL"  which  allow  to
  480.   select all files, or by the keyword "ARC"  which  allow  to  select  all
  481.   files with archive bit cleared.
  482.       The "OPTIONS" optional argument allow to change  backup  options
  483.   (CAUTION: by default, ALL options are reset) : "C" for compression,  "V"
  484.   for verifying, "A" to set archive bit, "L"  to  backup  links.  You  can
  485.   specify several options (for exemple "OPTIONS CV").
  486.       The NOCOMP option allows to specify extensions of file names    to
  487.   don't compress. You can specify up to  10  extensions,  separated  by  a
  488.   comma (e.g.: "NOCOMP .info,.run").
  489.       The "REPORT" optional argument allow to have  a  backup  report.
  490.   Specify "PRT:" as a file name in order to have this report printed.  The
  491.   "VERBOSE" optional argument allow to have more messages during backup.
  492.       The "BUFSIZE" optional argument allows to change the size of the
  493.   read buffer (for example "BUFSIZE 64" asks  for  a  64  Kb  buffer).  By
  494.   default, the buffer size is 4 Kb large.
  495.  
  496.       Restore is started with a command like:
  497.  
  498.       ABackup RESTORE FROM arc [TO    dir]  SELECT  {ALL|file}  [OPTIONS
  499.       {F|D|E|L}] [REPLACE  {YES|ASK|OLDER}]  [VERBOSE]  [REPORT  file]
  500.       [BUFSIZE size]
  501.  
  502.   where "arc" is the name of the archive. The "SELECT" argument allows  to
  503.   select files to restore: it must be followed by the name of a  selection
  504.   file (see previous section, for exemple "ABCK:SourcesFiles") or  by  the
  505.   keyword "ALL", which allow to select all files without having to  create
  506.   a selection file.
  507.       The "TO dir" optional argument allow to  restore  files  in  the
  508.   specified directory, rather than the directory they were at backup time.
  509.       The "OPTIONS" optional argument allow to change restore  options
  510.   (CAUTION: by default, ALL options are reset) : "F" to restore all  files
  511.   in the same directory,  "D"  to  restore  date,  "E"  to  restore  empty
  512.   directories, "L" to restore links. You can specify several options  (for
  513.   exemple "OPTIONS FE").
  514.       The "REPLACE" optional argument allow to  specify  what  ABackup
  515.   has to do if a file to restore already exists. It must  be  followed    by
  516.   "YES" (or "Y", the file is replaced), by "ASK"  (or  "A",  you  will  be
  517.   asked for confirmation), or by "OLDER" (or "O",  the  file  is  replaced
  518.   only if it's older than the one in the archive). By default,  files  are
  519.   not replaced.
  520.       The "REPORT" optional  argument  allow  to  have  a  restoration
  521.   report. Specify "PRT:" as a file name  in  order  to  have  this  report
  522.   printed. The "VERBOSE" optional argument allow  to  have  more  messages
  523.   during restore.
  524.       The "BUFSIZE" optional argument allows to change the size of the
  525.   read buffer (for example "BUFSIZE 64" asks  for  a  64  Kb  buffer).  By
  526.   default, the buffer size is 4 Kb large.
  527.  
  528.       Rebuilding catalogue is started with a command like:
  529.  
  530.       ABackup REBUILD FROM arc [VERBOSE] [BUFSIZE size]
  531.  
  532.   where "arc" is the name of the archive. The "VERBOSE" optional  argument
  533.   allow to have more messages during processing.  The  "BUFSIZE"  optional
  534.   argument allows to change the size  of  the  read  buffer  (for  example
  535.   "BUFSIZE 64" asks for a 64 Kb buffer). By default, the buffer size is  4
  536.   Kb large.
  537.  
  538.       Archive listing is started with a command like:
  539.  
  540.       ABackup LIST FROM arc [TO file]
  541.  
  542.   where "arc" is the name of the archive. The "TO file" optional  argument
  543.   allow to write the listing into the  specified  file,  rather  than  the
  544.   console window. Specify "PRT:" as a file name in order to have the  list
  545.   printed.
  546.  
  547.   11. Program history
  548.  
  549.       This program was developped on an Amiga 3000 UNIX-1 (6  Mb  RAM,
  550.   internal HD disk drive, internal hard disk of 100 Mb,  external  SyQuest
  551.   drive of 88 Mb, external  floppy  disk  drive,  1960    monitor  and  Star
  552.   LC24-10 printer) connected by a null-modem cable to an A500  with  1    Mb
  553.   RAM.
  554.       ABackup was written almost in  C  language,  and  compiled  with
  555.   SAS/C 5.10b. DPaint IV (from Electronic Arts), SID2 (by Tim Martin), and
  556.   DME (by Matt Dillon) were very useful too.
  557.  
  558.   12-Mar-92   development beginnning
  559.   08-Jun-92   v1.00, 58036 bytes
  560.  
  561.   20-Jun-92   v1.10, 59404 bytes
  562.           o Handles High Density floppy disks (1.76 Mb).
  563.           o When run from the Workbench, you can change  the  size    of
  564.         the read buffer with "BUFSIZE=<size in Kb>" in  the  "TOOL
  565.         TYPES" field of ABackup icon.
  566.           o Several changes in backup :
  567.         - when there is any problem at initialization  time,  goes
  568.           back to the selection screen
  569.         - when an archive file exists, or there is already a  disk
  570.           in drive, asks to confirm before starting writing
  571.         - tests if files to back up are protected against  a  read
  572.           (opening a file works in any case, but under 2.04 system
  573.           release you  will  be  kicked  out  at  the  first  read
  574.           operation)
  575.         - displays the compression  rate  for  every  file  (after
  576.           "OK")
  577.           o Several changes in the interface :
  578.         - added  the  "Size"  menu   in   the   selection   screen
  579.           (Bytes/Kb/Mb)
  580.         - displays backed-up/restored percentage and remaining one
  581.         - the "monitor" window (in blue) is larger when screen  is
  582.           in PAL mode
  583.           o Time valuation more accurate (uses the "timer.device").
  584.  
  585.   28-Jun-92   v1.20, 62616 bytes
  586.           o Added the "Selection" menu in the selection screen  :  you
  587.         can record a selection and recall it later.
  588.           o Fixed several bugs :
  589.         - as a result of an error in the  computing  of  remaining
  590.           place in the last disk, sometimes it wrote  a  catalogue
  591.           overlapping two different floppies
  592.         - when you swapped a disk during a file header writing, it
  593.           forgot to  set  up  the  disk  position  at  0  (in  the
  594.           catalogue)
  595.         - during a read, at the end of a  disk,  it  detected  one
  596.           byte earlier it had to ask for the next disk.
  597.           o For a by date selection, you can give the month name (e.g.
  598.         "01-Jan-92")
  599.           o When run from the Workbench, it does not  open    the  small
  600.         "console" window.
  601.  
  602.   01-Jul-92   v1.30, 67640 bytes
  603.           o Double-click upon a name starts a "view" operation
  604.           o Under 2.04  system  release,  uses  "dos.library"  pattern
  605.         matching functions (more powerful than SAS/C ones)
  606.           o Added "Estimation" option in "Backup" menu
  607.           o Displays error messages rather than error codes
  608.           o  Bug  fixed  in   "draggin   select":   didn't   displayed
  609.         directories when scrolling list
  610.           o Restore screen's title when "Abort" is selected on archive
  611.         selection menu (Restore)
  612.  
  613.   04-Jul-92   v1.31, 68316 bytes (Fish #706)
  614.           o Added "Restore date" option
  615.           o Added auditive beep in alert/wait functions
  616.           o No more need for "arp.library" to make drives "BUSY" under
  617.         1.3 system release
  618.           o Estimations more accurate (don't suppose that last disk is
  619.         full)
  620.  
  621.   22-Aug-92   v1.40, 78328 bytes
  622.           o Can use several disk drives for backup
  623.           o Full access from CLI ("batch" mode)
  624.           o Bug fixed: always tried to  decompress    archive  catalogue
  625.         (even if it was not)
  626.           o Bug fixed: when loading archive  file  catalogue,  scanned
  627.         all archive beginning (instead of going  straight  to  the
  628.         good location)
  629.           o Preparation of non-dos    partitions  backup  (most  of  the
  630.         required code written)
  631.           o Added visual beep to each auditive beep
  632.  
  633.   09-Sep-92   v1.50, 81068 bytes
  634.           o Added support for links under 2.04  system  release  (both
  635.         hard and soft links are handled)
  636.           o Added "Backup links" and "Restore links" options
  637.           o Added "Automatic" item to "Size" menu
  638.           o Added "NOCOMP ext,ext,..." argument
  639.           o When requesting a disk for writing, verifies that the disk
  640.         has really been changed before continuing
  641.           o If an error occurs while writing on a disk, make one retry
  642.           o Error in percentage computation corrected
  643.           o On selection screen, directories with at  list    one  child
  644.         selected are displayed on a black background
  645.           o No more overflow from "monitor" window if file name is too
  646.         long
  647.           o Bug fixed in SendPacket() function
  648.           o Bug fixed in time computation (00:29:59 + 1 gave  01:00:00
  649.         ... whoops !)
  650.           o Forgotten trace message removed
  651.  
  652.   07-Oct-92   v1.51, 81048 bytes
  653.           o Any file or directory whose comment begins  with  "SKIPME"
  654.         is ignored when loading directory tree
  655.           o Bug fixed : no more problems if the size of a file  change
  656.         between the time we load directory tree and time  we  save
  657.         the file
  658.           o Bug fixed : didn't  clear  destination  name  between  two
  659.         restore (so the second was made is the same directory than
  660.         the first)
  661.           o Update status display when disk is changed
  662.  
  663.   15-Oct-92   v1.60, 84312 bytes
  664.           o Added function to rebuild catalogue
  665.           o Selection screen modified  (added  "OPTIONS"  and  "START"
  666.         gadgets, etc...)
  667.           o Estimations for 68000 Amigas corrected (thanks to JYP !)
  668.           o If a file is read protected (under 2.0 system release) ask
  669.         for retry
  670.           o When restoring, display  the  name  of    the  file  created
  671.         instead of the name in the archive
  672.           o Restore option "At the same level" renamed  "Restore  dir.
  673.         tree"
  674.  
  675.   Planned improvements :
  676.           o Support for non-AmigaDOS partitions (AMAX, etc...)
  677.           o Function for rebuilding  an  archive  catalogue  (even  if
  678.         there are missing disks).
  679.           o When it will run into a hard error in a disk, it will  ask
  680.         for a replacement disk and will write  again  all  of  the
  681.         files already written on the faulty disk.
  682.  
  683.  
  684.  
  685.  
  686.